home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ftn / libexc.z / libexc
Encoding:
Text File  |  1998-10-30  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LLLLIIIIBBBBEEEEXXXXCCCC((((3333FFFF))))                                                          LLLLIIIIBBBBEEEEXXXXCCCC((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      trace_back_stack, trace_back_stack_and_print - call stack trace library
  10.      for Fortran applications
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ttttrrrraaaacccceeee____bbbbaaaacccckkkk____ssssttttaaaacccckkkk
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 iiii
  15.      iiiinnnntttteeeeggggeeeerrrr****8888 aaaaddddddddrrrrssss((((111100000000))))
  16.      cccchhhhaaaarrrraaaacccctttteeeerrrr****111100000000 nnnnaaaammmmeeeessss((((111100000000))))
  17.      iiii ==== ttttrrrraaaacccceeee____bbbbaaaacccckkkk____ssssttttaaaacccckkkk((((0000,,,, aaaaddddddddrrrrssss,,,, nnnnaaaammmmeeeessss,,,,
  18.                                    111100000000,,,, 111100000000))))
  19.  
  20.      ccccaaaallllllll ttttrrrraaaacccceeee____bbbbaaaacccckkkk____ssssttttaaaacccckkkk____aaaannnndddd____pppprrrriiiinnnntttt(((())))
  21.  
  22.      iiiinnnntttteeeeggggeeeerrrr****8888 aaaaddddddddrrrr,,,, eeeennnnttttrrrryyyy
  23.      cccchhhhaaaarrrraaaacccctttteeeerrrr****111100000000 nnnnaaaammmmeeee
  24.      ccccaaaallllllll eeeexxxxcccc____ddddllllaaaaddddddddrrrr((((aaaaddddddddrrrr,,,, nnnnaaaammmmeeee,,,, 111100000000,,,, eeeennnnttttrrrryyyy))))
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      The _l_i_b_e_x_c library provides the functionality for user-level call stack
  28.      unwind.
  29.  
  30.      ttttrrrraaaacccceeee____bbbbaaaacccckkkk____ssssttttaaaacccckkkk is used to unwind the call stack at the time it's
  31.      called.  The first argument sets the number of stack frames to be
  32.      unwound.  If it's set to zero the unwind continues up to main or up to
  33.      _nsproc/_fork for child processes.  The second argument is the array that
  34.      contains the addresses of the callers in the stack after the unwind is
  35.      completed. The third argument contains the names of the functions in the
  36.      stack after the unwind is completed. If this argument is set to NULL, it
  37.      disables procedure name extraction. The fourth argument is the size of
  38.      the array of callers and the fifth argument is the size of the procedure
  39.      name strings.
  40.  
  41.      ttttrrrraaaacccceeee____bbbbaaaacccckkkk____ssssttttaaaacccckkkk____aaaannnndddd____pppprrrriiiinnnntttt unwinds the call stack (up to main or up to
  42.      _nsproc/_fork for child processes) and prints it to the standard output.
  43.      First, the pid of the process and the number of frames in the stack are
  44.      printed and then, for each frame, the program counter and the function
  45.      name.
  46.  
  47.      eeeexxxxcccc____ddddllllaaaaddddddddrrrr maps a text address to the procedure that includes it.  The
  48.      first argument is the address to be mapped.  The second argument will
  49.      contain the procedure name upon return and the third argument is the size
  50.      of the procedure name string.  The fourth argument will contain the
  51.      procedure entry address upon return.
  52.  
  53. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  54.      ____LLLLIIIIBBBBEEEEXXXXCCCC____CCCCAAAACCCCHHHHEEEE when set enables dwarf information caching (N32/N64 ABI's
  55.      only).
  56.  
  57.      ____LLLLIIIIBBBBEEEEXXXXCCCC____NNNNOOOO____PPPPRRRROOOOCCCC____NNNNAAAAMMMMEEEE when set disables procedure name extraction (N32/N64
  58.      ABI's only).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLIIIIBBBBEEEEXXXXCCCC((((3333FFFF))))                                                          LLLLIIIIBBBBEEEEXXXXCCCC((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      ____LLLLIIIIBBBBEEEEXXXXCCCC____IIIINNNNIIIITTTT when set forces some dwarf information loading at the time
  75.      of the first call to the libexc functions (N32/N64 ABI's only).
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      speedshop(1), libexc(3)
  79.  
  80. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  81.      Upon successful completion, both functions return the number of call
  82.      stack frames that were unwound.  In the event of failure, a zero value is
  83.      returned.
  84.  
  85. NNNNOOOOTTTTEEEESSSS
  86.      Executables complying to the o32 ABI have to be explicitly linked with
  87.      libexc.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.